CreatePictureSearchJob

调用该接口创建一体化以图搜图任务,即同时检索人脸和人体特征的任务。

使用限制

  • 单个阿里云账号调用该接口的每秒请求数(QPS)最大限制为100。
    说明 RAM用户共享阿里云账号配额。
  • 请提前在V系列边缘一体机上部署人脸和人体检测算法。
  • 请提前为待检索图片,配置URL地址。
    说明 当前仅支持JPG格式的图片,且图片URL中不能包含中文。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreatePictureSearchJob

系统规定参数。取值:CreatePictureSearchJob。

AppInstanceId String 3e429560124b44b685095df81a27****

以图搜图应用实例ID。可调用QueryPictureSearchApps接口查询。

StartTime Long 1614227915000

检索起始时间,格式为13位时间戳,单位为毫秒。

EndTime Long 1614327915000

检索结束时间,格式为13位时间戳,单位为毫秒。

SearchPicUrl String https://example.com/test.jpg

待检索图片的地址,支持JPG格式的图片,且图片URL不能包含中文。

Threshold Float 0.5

人脸检索阈值,取值范围为0.0~1.0。

说明 为保证检索结果的准确性,推荐您将该参数的值设置在0.3~0.6之间。
BodyThreshold Float 0.9

人体检索阈值,取值范围为0.0~1.0。

说明
  • 为保证检索结果的准确性,推荐您将该参数值设置为大于等于0.8。
  • 若此处不设置,则人体检索阈值,默认为与Threshold参数值相同。
PictureSearchType Integer 1

检索类型:

  • 1(默认):人脸
  • 0:人体

调用API时,除了本文介绍的该API的特有请求参数,还需传入公共请求参数。公共请求参数说明,请参见公共参数文档

返回数据

名称 类型 示例值 描述
Code String 200

接口返回码:

  • 200:表示成功。
  • 其它:表示错误码。错误码详情,请参见错误码
Data String 71632df011294a85910c566e7181****

一体化以图搜图任务ID。

ErrorMessage String The request has failed due to a temporary failure of the server.

调用失败时,返回的出错信息。

RequestId String FAEBE068-07DE-4B88-AC2A-51FC2B556211

阿里云为该请求生成的唯一标识符。

Success Boolean true

是否调用成功:

  • true:调用成功。
  • false:调用失败。

示例

请求示例

http(s)://linkvisual.cn-shanghai.aliyuncs.com/?Action=CreatePictureSearchJob
&AppInstanceId=3e429560124b44b685095df81a27****
&StartTime=1614227915000
&EndTime=1614327915000
&SearchPicUrl=https://example.com/test.jpg
&Threshold=0.5
&<公共请求参数>

正常返回示例

XML格式

<CreatePictureSearchJobResponse>
  <RequestId>DB14A78C-6F64-40D0-8C03-46E8D57A8FC8</RequestId>
  <Data>71632df011294a85910c566e7181****</Data>
  <Code>200</Code>
  <Success>true</Success>
</CreatePictureSearchJobResponse>

JSON格式

{
  "RequestId": "DB14A78C-6F64-40D0-8C03-46E8D57A8FC8",
  "Data": "71632df011294a85910c566e7181****",
  "Code": "200",
  "Success": true
}